home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor2 / readme.1st < prev    next >
Text File  |  1993-02-18  |  4KB  |  114 lines

  1. RPL48, a System RPL and Machine Language program developer's toolkit.
  2.  
  3. [Note: If you're not sure what System RPL is, or whether you need it,
  4.  please read RPL.DOC in the POSTINGS directory on this disk.  It's my
  5.  attempt to make the whole subject understandable.  -jkh-]
  6.  
  7. This is version 1.12 beta of the RPL48 development toolkit for the HP48SX.
  8.  
  9. RPL48 v1.12b consists of the following files:
  10.  
  11. RPL      LIB - the <-RPL->:4.1b library
  12. LIB      LIB - the <-LIB->:1.7 library
  13. RPL      TAB - the reference table
  14. RPLXMPL  DIR - sources of sys-RPL example programs (see below)
  15. LIBXMPL  DIR - <-LIB->:1.7 example
  16. QIX      DIR - source of a little animation demo
  17. CNFLIB   DIR - source of a warmstart configuration library
  18. CNFLIB   DOC - documentation for CNFLIB.DIR
  19. BINTS    DIR - <-LIB->:1.7 example
  20. LINE         - ->COD example
  21. BNF      DIR - source of a BNF parser generator
  22. BNF      DOC - documentation for BNF.DIR
  23. GENTAB   C   - a reference table generator written in ANSI C
  24. LIBRARY  DOC - a text from C.Patton about libraries, (c) by C.Patton, HP Cv.
  25. RPL48    DOC - RPL48 toolkit documentation (plain ASCII)
  26. README   1ST - this file
  27.  
  28. The following two libraries are alpha versions of the MKROM command and the
  29. debugger written by Mika Heiskanen (mheiskan@vipunen.hut.fi), both libraries
  30. are requiring an installed <-RPL-> library with a serial no. in the reange
  31. 97-113. ATTENTION: USE WITH CAUTION !!!
  32.  
  33. MKROM    LIB - MKROM library
  34. MKROM    DOC - brief doc of MKROM
  35. MKROMX   DIR - MKROM input example
  36. DEBUG    LIB - DEBUG library
  37. DEBUG    DOC - brief doc of DEBUG
  38.  
  39. Even the <-RPL-> library is branded to J.K.Horn, RPL48 v1.12b is GiftWare,
  40. please refer to RPL48.DOC, chapter 1.1 and Appendix C for further information.
  41.  
  42. Know problems with <-RPL->:4.1b:
  43.  - don't use EC A-Z { on the supplied reference table - a bug in EC causes
  44.    a jam the display in this special case and I'm not shure about its side
  45.    effects (no mem lost yet, but I've done a ON-C immediately..)
  46.  
  47.  
  48. Here's a brief description for the programs of the XMPL directory:
  49.  
  50. SETUP   ( --> dir )
  51.     Compiles the entire directory
  52.  
  53. UP      ( --> )
  54.     User friendly UPDIR - could be bound to 31.2
  55.  
  56. MON     ( --> $ )
  57.     A little memory monitor
  58.  
  59. LBLD    ( --> grob grob )
  60.     A little menu label drawing utility
  61.  
  62. PBYTES  ( % --> %' )
  63.     Returns the amount of memory used in a port (even of a WPed port)
  64.  
  65. ->rpl   ( $ --> ob )
  66.     A little shell for ->RPL
  67.  
  68. DCD     ( dir --> dir' )
  69.     DeCompile Directory. Usefull for dirs generated by L->DIR
  70.  
  71. CCD     ( --> dir )
  72.     Compile Current Directory (SETUP compiles this program 1st and uses
  73.     it for compiling the whole dir)
  74.  
  75. tEVAL   ( ob --> ? unit )
  76.     Returns the execution time of ob in ms
  77.  
  78. FIXIT   ( $ --> ob )
  79.     Tries to fix bad d/l string (the junk that starts with 'HPHP48-x..'
  80.     after d/l). Bases on Joe Horns FIXIT.
  81.  
  82. ITYPE   ( ob --> # )
  83.     Returns the object type of ob for use with CK<n>... words
  84.  
  85. cst     ( --> {} )
  86.     A sample CST menu
  87.  
  88. DAR     ( hxs --> $ )
  89.     DisAssemble Rom. More or less interactive disassembling of ROM based code
  90.  
  91. Strip   ( ob --> ob' )
  92.     Strips the superflous words from user-RPL programs
  93.  
  94. GetKO   ( --> ob % )
  95.     Waits for a full keystroke and returns its key object and the key value
  96.  
  97. F&R     ( $s $f $r --> $' )
  98.     Search $s for all $f and replace them by $r
  99.  
  100. DBG
  101.     Displays the user stack and waits for a keypress. Any other key than
  102.     <ENTER> causes an ABORT to be executed. Usefull for taking a look at
  103.     the stack from within a program
  104.  
  105. Types   ( --> )
  106.    Displays a little table of CK<n>... dispatch values
  107.  
  108. Time    ( --> )
  109.    A running BIG digital clock. Press any key to quit it
  110.  
  111.  
  112. Enjoy,
  113.         8-Detlef & Raymond
  114.